home *** CD-ROM | disk | FTP | other *** search
/ Internet Warrior 1993 July / Internet Warrior No. 1 July 1993 - Austin Code Works.ISO / apps / pcgopher / utgopher.exe / UGOPHER.DOC < prev    next >
Encoding:
Text File  |  1993-01-14  |  4.7 KB  |  126 lines
  1.          Internet Gopher Curses Client Documentation
  2.                University of Minnesota
  3.  
  4.  
  5. I. Overview of the Internet Gopher Curses Client.
  6.  
  7. The Internet Gopher is a distributed document delivery service.  It
  8. allows a neophyte user to access various types of data residing on
  9. multiple hosts in a seamless fashion.  This is accomplished by
  10. presenting the user a hierarchical arrangement of documents and by
  11. using a client-server communications model.  The Internet Gopher
  12. Curses Client allows a user on a terminal to access the vast array of
  13. information available on various gopher servers.
  14.  
  15. II.  Installing Gopher
  16.  
  17. Copy UGOPHER.EXE and GOPHER.HLP to any directory together. The program
  18. expects to find its help file in the current directory.
  19.  
  20. III. Using Gopher
  21.  
  22. To use the gopher just type "ugopher".  You will be connected up to the
  23. root gopher server.  You can aim the Gopher client at an alternative
  24. server if you wish.  Just give the parameters on the command line like
  25. this: 
  26.  
  27. % gopher oac3.hsc.uth.tmc.edu 70
  28.  
  29. There is one option available '-s'.  This option flag disables saving
  30. and printing in the client.  This is quite useful for gopher clients
  31. that are publicly accessable.
  32.  
  33. The following commands are available in the browsing mode.
  34.  
  35. l <Return>  View current item.
  36. <Number>    Move to a line #.
  37. k C-p       Move pointer up.
  38. j C-n       Move pointer down.
  39. h u         Go up a level.
  40. Q           Exit Internet Gopher.
  41. O           Change Gopher Options.
  42. ?           This help screen.
  43.  
  44. Note that the hjkl grouping is backup/down/up/forward.
  45.  
  46. Each object can be identified by it's "extension"
  47.  
  48. /           Item is a directory.
  49. .           Item is a text file.
  50. <?>         Item is a search index.
  51. <CSO>       Item is a CSO phone book.
  52. <TEL>       Item is a telnet session.
  53. <)          Item is a sound (looks like a speaker)
  54.  
  55.  
  56.  
  57. Notes on the DOS PC/TCP port:
  58.  
  59. This port is essentially true to the unix curses version.  A curses
  60. emulation for DOS by Bjorn Larsson was used, with a bit of tweaking to
  61. make it properly recognize screens with more than the normal 24 lines if
  62. you have EGA or better.
  63.  
  64. The sound option is enabled, but not set to anything.  If you have
  65. utilities to play sounds on your PC you may use them.
  66.  
  67. In addition, support for getting and viewing CompuServe GIF format files
  68. has been added.  The GIF viewer can be set in the options screen.
  69.  
  70. During my work porting v. 0.9 to DOS, the folks at Minnesota release v 1.0.
  71. Of the changes included in that release, I implemented these:
  72.  
  73.      You can use environment variables to set up the various commands.
  74.  
  75.           PAGER -  sets the text file browser.
  76.           PLAYER - sets the audio player.
  77.           VIEWER - sets the image viewer.
  78.           MAILER - sets the mail command.
  79.       TELNET - sets the telnet command.
  80.      These are all optional, you may use the defaults or set them with
  81.      the options screen in ugopher.
  82.  
  83.      User can now escape from the Telnet/TN3270 connection screen.
  84.  
  85.      Client now does nifty twirl output to let you know it's up to
  86.      something.  It currently does this for directories (one twirl per
  87.      entry) and textfiles/cso searches (one twirl per 25 lines)  This
  88.      stuff is adapted from the panda code.
  89.  
  90.      Added more information on connections.  It displays "connecting..."
  91.      before it displays "retrieving directory..."
  92.  
  93.      Client beeps at you if you press the wrong keys now.
  94.  
  95.      The client doesn't redisplay the menu when an invalid key is pressed.
  96.      
  97.      Added fix from John Sellens that allows the user to escape from a CSO
  98.      query.
  99.  
  100.      Made the interface more consistent.  Pressing 'l' will let you
  101.      enter into an item (just like return and the right arrow..)
  102.      Pressing 'h' will go up a level.  (Glenn F. Leavell). 
  103.  
  104. **The two big changes for v 1.0, bookmarks and the gopherrc file, were
  105. NOT implemented.
  106.  
  107. I also squished a few bugs:
  108.  
  109. Curses routines were getting called after after the program shut down
  110. the curses environment to shell out, but before reinitialize curses.
  111. Apparently this is harmless in unix, but the DOS emulation would hang.
  112.  
  113. After retrieving a file from a gopher server the connection was not getting
  114. closed.  The result was that eventually gopher would use up all the PC/TCP
  115. kernel's configured tcp connections, and not release them until it exited.
  116.  
  117. When you go up a menu or return to the root menu, the title is reset
  118. correctly.
  119.  
  120. Some malloc()'ed memory was not getting freed.  I can't say for sure I've
  121. cleaned every stray memory leak, but it is much better.
  122.  
  123. The gopher client was ported to DOS by the Office of Academic
  124. Computing. You may send email to info@oac.hsc.uth.tmc.edu for
  125. questions or bug reports.
  126.